home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / gfx / misc / PGMKey.readme < prev    next >
Text File  |  2000-05-02  |  3KB  |  65 lines
  1. Short:        Find double pictures by id's. V1.2
  2. Author:       Nagilum
  3. Uploader:     nagilum@chillout.org
  4. Type:         gfx/misc
  5. Requires:     OS3.0+,020+,Shell
  6. Replaces:     PBMKey.lha
  7. Distribution: Aminet
  8.  
  9. Archive content:
  10.  PGMKey (1180 bytes)        - the binary
  11.  PGMKey.readme (2229 bytes)    - this readme
  12.  PGMKey.s (3930 bytes)        - the source (asm)
  13.  setnote (593 bytes)        - an example script
  14.  
  15. What's the use ?
  16.  You can use this program to find pictures having the same content, 
  17.  even when they have different size.
  18.  
  19. Why PGM ?
  20.  This program can be used to create ID's for PGM-pictures.
  21.  You may ask yourself, why the the hell PGM and not jpeg, iff or png ?
  22.  Well, the first reason is that PGM has a very simple structure,
  23.  and the second is that for all important formats exist command-line
  24.  converters to PGM.
  25.  This program requires 256 Grayscale pictures in PGM to work,
  26.  those pictures start with P5 in the header and can easily created
  27.  for example from jpeg: djpeg -grayscale ...
  28.  This programm was written in about 4 hours and i know it's not very
  29.  clean, but it works (even fast).
  30.  
  31. How does it work ?
  32.  The program calculates the average over the whole picture, then splits
  33.  the picture into 64 pieces and calculates the average for each piece,
  34.  then depending on if the average from the piece is lower/equal 
  35.  or higher to the total average it sets a bit in the id to 0 or 1.
  36.  64 pieces create 64 bits, this id will be printed as a 16 digits hex number.
  37.  Usually the ID remains the same if the picture is scaled.
  38.  
  39. You could use a script like the one included (setnote) to put the pictures id
  40. in the filename, after that you could sort the files by the id and easily
  41. remove double pictures. If you want to use pattern for selecting the pictures
  42. just type:  spat setnote Pictures/#?.jpg  (for example).
  43.  
  44. Version history:
  45.     1.0 - initial announcement
  46.     1.1 - fixed a bug in the args parsing, increased the filename buffer
  47.           (thx to Jose Andias for the impulse to release this update)
  48.     1.2 - forgot to increase the loop count for the filename loop, 
  49.           finally got the name correct PGM - Portable Gray Map .-)
  50.  
  51. DISCLAIMER: THE AUTHOR IS NOT RESPONSIBLE FOR ANY DAMAGE OR LOSS
  52. OF DATA OR WHATEVER CAUSED BY PGMKey. ANYONE USES IT WITHOUT WARRANTY.
  53.  
  54.  
  55. ============================= Archive contents =============================
  56.  
  57. Original  Packed Ratio    Date     Time    Name
  58. -------- ------- ----- --------- --------  -------------
  59.     1180     544 53.8% 01-Mar-00 01:07:28  PGMKey
  60.     2229    1197 46.2% 01-Mar-00 01:19:10  PGMKey.readme
  61.     3930    1485 62.2% 01-Mar-00 01:07:14  PGMKey.s
  62.      593     298 49.7% 29-Feb-00 10:27:00  setnote
  63. -------- ------- ----- --------- --------
  64.     7932    3524 55.5% 01-Mar-100 19:58:00   4 files
  65.